8bitfiles.net/archives

home *** CD-ROM | disk | FTP | other *** search

/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C128Toolkit / ASTRO-MENU-V3.1-..SDA / ASTRO DOCS 3.1 < prev next >

Wrap

Text File | 2019-04-13 | 16.1 KB | 328 lines

******************************************************************************** ******************************************************************************** ********************************* :: ********************************** ****************************** :::: ******************************* *************************** :::::: **************************** ************************ :::::::: ************************* ********************* :::::::::: ********************** ****************** ::: :::: ::: ******************* *************** ::: :::::: ::: **************** ************ ::: :::::::: ::: ************* ********* ::: :::::::::: ::: ********** ****** ::: :::::::::::: ::: ******* **** ::: :::::::::::::: ::: **** ** ::: :::::::::::::::: ::: ** ** ::: :::::::::::::::::: ::: ** ** ::: :::::::::::::::::::: ::: ** ** ::: :::::::::::::::::::::: ::: ** ** ::: :::::::::::::::::::::::: ::: ** ** ::: :::::::::::::::::::::::::: ::: ** ** ::: :::::::::::::::::::::::::::: ::: ** ** :::::::::::::::::::::::::::::::::::::: ** ** :: :: ** ** :: :: ** ** :: :: ** ** :: :: ** ** :: :: ** ** :: :: ** ** :: ┴╙╘╥╧ ═┼╬╒ / ┴╙╘╥╧ ╫╥╔╘┼╥ :: ** ** :: :: ** ** :: ─OCUMENTATION FOR ╓ERSION 1.0 :: ** ** ::(├) ├OPYRIGHT 1990 BY ╠OWELL ╞UHER:: ** ** :: ┴╠╠ RIGHTS RESERVED :: ** ** :: :: ** ** :: :: ** ** :: :: ** ** :: :: ** ** :: :: ** ** :: :: ** ** :: :: ** ** :: :: ** ** :: :: ** ** :: :: ** ** :: :: ** ** :: :: ** ** :: :: ** ** ::: ::: ** ** :::: :::: ** ** ::::: ::::: ** ** :::::: :::::: ** ** ::::::: ::::::: ** ** :::::::: :::::::: ** ** ::::::::: ::::::::: ** ** :::::::::: :::::::::: ** ** ::::::::::: ::::::::::: ** ** :::::::::::: :::::::::::: ** ** ::::::::::::: ::::::::::::: ** ** :::::::::::::: :::::::::::::: ** ** ::::::::::::::: ::::::::::::::: ** ** :::::::::::::::: :::::::::::::::: ** ** ::::::::::::::::: ::::::::::::::::: ** ** :::::::::::::::::: :::::::::::::::::: ** ** ::::::::::::::::::: ::::::::::::::::::: ** ** :::::::::::::::::::: :::::::::::::::::::: ** ******************************************************************************** ******************************************************************************** ┴╙╘╥╧ ═┼╬╒ ╨┴╟┼ 2 ├╧╨┘╥╔╟╚╘ ┴T THE TIME OF THIS WRITING THIS PROGRAM IS THE SOLE PROPERTY OF THE OWNER AS STATED BELOW. ╧╫╬┼╥ ╘HIS PROGRAM AND THE PROGRAMS AND DOCUMENTATION THAT ACCOMPANIES IT IS OWNED BY: ╠OWELL ╫M. ╞UHER ╥OUND ╘UIT ╙OFTWARE 420 ╫. 20TH ┴VE ╦ENNEWICK, ╫A. 99337 ╙╚┴╥┼╫┴╥┼ ╘HIS PROGRAM IS BEING RELEASED AS SHAREWARE. ╘HIS MEANS THAT THE OWNER IS REQUESTING THAT IF YOU FIND THIS PROGRAM USEFULL, YOU SEND A DONATION TO HIM AT HIS HOME ADDRESS AS LISTED ABOVE. ═ANY MANY HOURS AND TRIAL PROGRAMS HAVE GONE INTO WHAT WE NOW CALL VERSION 3.1. ╔ ASK THAT YOU GIVE $5 FOR MY TIME AND EFFORTS. ╞OR $10 ╔ WILL INSTALL YOUR NAME IN MY DATABASE FOR UPDATES, NEW PROGRAMS AND THE LIKE. ╘HE CHOICE IS YOURS. ╒.╙. ├URRENCY OR CHEQUES ONLY. ─╔╙├╠┴╔═┼╥ ╘HE AUTHOR MAKES NO WARRANTY, EITHER EXPRESSED OR IMPLIED, AS TO THE FITNESS OF ┴STRO ═ENU/┴STRO ╫RITER AND RELATED MATERIALS FOR ANY PARTICULAR PURPOSE. ╔N NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DAMAGES IN CONNECTION WITH OR ARISING OUT OF PURCHASE OR USE OF ┴STRO ═ENU/┴STRO ╫RITER. ╘HE SOLE AND EXCLUSIVE LIABILITY OF THE AUTHOR SHALL NOT EXCEED THE PURCHASE PRICE OF THE MATERIALS DESCRIBED HEREIN. ─┼╙├╥╔╨╘╔╧╬ ╫HAT IT ┴╙╘╥╧ ═┼╬╒? ╘HE PROGRAMS THAT ╔ CALL ┴╙╘╥╧ ═┼╬╒/┴╙╘╥╧ ╫╥╔╘┼╥ ARE ACTUALLY ONE IN THE SAME. ┴╙╘╥╧ ╫╥╔╘┼╥ WILL IN FACT CREATE ┴╙╘╥╧ ═┼╬╒. ╘HIS IS DONE INSIDE THE PROGRAM ITSELF. ╫HEN YOU RUN ┴╙╘╥╧ ╫╥╔╘┼╥ YOUR END RESULT WILL BE ┴╙╘╥╧ ═┼╬╒. ╘HIS IS ACCOMPLISHED WITH SIMPLE ┬┴╙╔├ COMMANDS, AND IN FACT THE ENTIRE PROGRAM IS WRITTEN IN ┬┴╙╔├ AND COULD BE A LEARNING EXPERIENCE FOR NEW AND SEASONED PROGRAMERS. ┴╙╘╥╧ ═┼╬╒ IS A USER FRIENDLY MENU PROGRAM. ╩UST PROGRAM IN YOUR PROGRAMS NAMES AND THE MENU SYSTEM WILL BUILD ┴╙╘╥╧ ═┼╬╒ RIGHT BEFORE YOUR VERY EYES. ┴╙╘╥╧ ═┼╬╒ ╨┴╟┼ 3 ╔╬╘╥╧─╒├╘╔╧╬ ╫ORK ON ┴STRO ═ENU/┴STRO ╫RITER HAS BEEN GOING ON FOR SEVERAL MONTHS NOW. ╫E SEE LARGE AMOUNTS OF MENU PROGRAMS IN THE PUBLIC DOMAIN BUT THEY ALL SEEM TO LACK THE ABILITY TO MAKE THEMSELVES USER CONFIGURED AS WELL AS USER FRIENDLY. ╔ HAVE GONE BEYOND THE USER FRIENDLY AND MADE IT VERY SIMPLE TO CONFIGURE AND RUN. ┬Y FOLLOWING THESE DIRECTIONS YOU WILL END UP WITH A ╙┘╙╘┼═ NOT JUST A SIMPLE MENU. ┴STRO ═ENU IS WRITTEN TOTALLY IN ┬┴╙╔├ SO THAT THE OWNERS MAY UNDERSTAND AND THE PROGRAMMERS OUT THERE CAN MAKE IT EVEN MORE CUSTOMIZED FOR THEIR PARTICULAR PURPOSE. ─┴╬╟┼╥╙ ╘HERE ARE ONLY A VERY FEW WARNINGS THAT NEED TO BE BROUGHT UP. ╦EEP ┴╙╘╥╧ ╫╥╔╘┼╥ ON A WRITE PROTECTED DISK. ┴LSO, USE YOUR FAVORITE COPY PROGRAM TO MAKE A BACKUP OF ALL THE ┴STRO ╨ROGRAMS. ╘HE ONLY OTHER WARNING IS WHILE THE PROGRAM IS RUNNING FOR THE INITIAL SETUP, KEEP YOUR HANDS OFF THE KEY BOARD. ╘HE PROGRAM RE-CONSTRUCTS ITSELF, AND IS IN THE PROCESS OF MAKING DRASTIC CHANGES TO THE PROGRAM LINES, AND YOUR FINGERS COULD RUIN ALL YOUR WORK, BUT IF YOU DO, YOU CAN STILL START ALL OVER. ├╧══┴╬─ ╫╔╬─╧╫ ╘HE ├OMMAND ╫INDOW SHOWS YOU WHAT YOUR SELECTIONS ARE FROM WITHIN YOUR MENU. ╔T SHOWS THE TITLE OF YOUR PROGRAMS WHICH YOU HAVE PROGRAMED INTO THE MENU, AND A LETTER NEXT TO EACH TITLE WHICH YOU USE TO SELECT THE TITLE. ╞╒╬├╘╔╧╬ ╦┼┘╙ ╞1 -- ╙╘╧╨ ╘HIS DOES JUST WHAT IT SAYS, IT WILL DO AN INSTANT STOP OF THE PROGRAM. ╞2 -- ┬ASIC 2 ╘HIS COMMAND WILL TAKE YOU TO 64 MODE, REMEMBER YOU WILL HAVE TO CHANGE TO 40 COLUMN UPON EXECUTION. ╞3 -- ┬ASIC 7 ╘HIS COMMAND WILL ╬┼╫ YOUR PROGRAM AND RECONSTRUCT YOUR ╞UNCTION ╦EYS. ═ORE ON THIS LATER. ╞4 -- ─╔╙╦ ╘HIS COMMAND WILL LOAD AND RUN A PROGRAM ON YOUR DISK NAMED "─╔╙╦". ═ORE LATER. ╞5 -- ├┴╘┴╠╧╟ ╘HIS WILL PRINT A DIRECTORY ON YOUR SCREEN FROM DRIVE 8. ╞6 -- ─╔╥/╨╥╘ ╘HIS WILL PRINT THE DIRECTORY OF DRIVE 8 TO YOUR PRINTER. ═ORE LATER. ╞7 -- ╚┼╠╨ ╞╔ ╘HIS WILL LOAD AND RUN A PROGRAM FROM YOUR DISK NAMED "╚┼╠╨╞╔". ═ORE LATER. ╞8 -- ├╚╟/─╥╔ ╘HIS WILL SOFTWARE CHANGE YOUR DRIVES TO DIFFERENT NUMBERS, SWAP, CHANGE, ETC. ═ORE LATER. ╚╧═┼ ├╧══┴╬─ ╘HE COMMAND ╚╧═┼ FROM A SUB MENU WILL TAKE YOU BACK TO THE ═AIN ═ENU. ┴╙╘╥╧ ═┼╬╒ ╨┴╟┼ 4 ╥╒╬╬╔╬╟ ┴╙╘╥╧ ╫╥╔╘┼╥ --------------------------------- ╔N ORDER FOR ┴STRO ═ENU TO BE OPERABLE FOR YOU, YOU MUST RUN THE ┴╙╘╥╧ ╫╥╔╘┼╥ PROGRAM. ╔N FACT, THE ┴STRO ═ENU PROGRAM IS INSIDE ┴STRO ╫RITER, AND WE JUST HAVE TO DELETE A BUNCH OF PROGRAM LINES TO GET TO IT. ╘HATS EASY, JUST FOLLOW THE DIRECTIONS AND IT WILL TAKE PLACE ALL BY ITSELF. ╞IRST OFF, YOU NEED TO DETERMINE WHAT 14 TITLES YOU WILL HAVE IN YOUR ═AIN ═ENU. ╘HESE CAN BE SIMPLE TITLES SUCH AS THE NAME OF YOUR FAVORITE TERMINAL PROGRAM, FILE EDITOR PROGRAMS, GAMES, ETC. ╧╥ THEY CAN BE TITLES OF ╙╒┬ ═┼╬╒╙, SUCH AS ╨╥╔╬╘┼╥ ╨╥╧╟╥┴═╙, ╘┼╥═╔╬┴╠ ╨╥╧╟╥┴═╙, ┼─╔╘╧╥ ╨╥╧╟╥┴═╙, ETC. ╘HEN WHEN YOU CREATE YOUR ╙UB ═ENUS YOU CAN GET TO THE NITTY GRITTY OF IT. ╙O DETERMINE WHAT YOU WANT AND PROCEED. ╧NE OF THE FIRST QUESTIONS YOU WILL HAVE TO ANSWER IS WHETHER OR NOT THIS IS A SUB MENU. ╔F IT IS YOU WILL HAVE TO GIVE IT A ╙UB ═ENU ╬AME, SUCH AS "╨╥╔╬╘┼╥ ╨╥╧╟╥┴═╙". ┘OU WILL HAVE TO KEEP THIS TITLE TO 16 CHARACTERS OR LESS, AND TRY TO CENTER IT. ┼XAMPLE; IF YOUR TITLE IS ╒╘╔╠╔╘╔┼╙, THEN THERE ARE 9 LETTERS IN THE WORD ╒TILITIES LEAVING 7 SPACES. 16 - 9 = 7 IF MY MATH IS CORRECT. ╙╧ LEAVE 4 SPACES BEFORE THE WORD ╒╘╔╠╔╘╔┼╙ AND HIT RETURN AND IT WILL BE CENTERED.╔F YOU FIND OUT LATER THAT IT'S NOT JUST RIGHT, LINE 6000 IN THE PROGRAM HOLDS THAT VARIABLE, AND YOU CAN CHANGE IT, OR JUST RECREATE THE WHOLE PROGRAM. ╬╧╫ IS WHERE IT MAKES IT'S FIRST CHANGES. ╫ATCH THE LINE NUMBERS COME UP ON THE SCREEN AND JUST BEGIN WHEN YOU GET THE NEXT PROMPT. ╘HE NEXT 28 PROMPTS WILL ASK FOR THE TITLE OF THE PROGRAM AND THEN THE ╨ROGRAM ╬AME AS IT APPEARS ON THE DISK DIRECTORY. ╘HE TITLE IS WHAT EVER YOU WANT TO CALL IT REMEMBERING TO KEEP IT TO 18 LETTERS, IF NOT YOU'LL JUST OVER FLOW, NO BIG DEAL. ╦EEP THE PROGRAM NAME EXACT OR YOU'LL GET A DISK ERROR AND NO LOAD. ╫HEN YOU HAVE ENTERED ALL 14 SETS OF NAMES, IT WILL SHOW THEM ALL TO YOU IN ORDER AND CHECK THEM TO MAKE SURE YOU HAVE IT CORRECT. ╔F NOT TELL IT SO. ╘HEN SIT BACK AND WATCH AGAIN WHILE THE PROGRAM CHANGES TO THE FINISHED FORM OF ┴╙╘╥╧ ═┼╬╒. ╙AVE THE PROGRAM TO DISK UNDER THE NAME OF "ASTRO MENU" . ╔F IT WAS A SUB MENU, SAVE IT UNDER THE NAME YOU CHOSE. ╔T'S DONE! ┴STRO ═ENU WILL NOW RUN. ╔F YOU MAKE IT AN AUTO BOOT PROGRAM, AND PUT IT FIRST ON YOUR DISK YOU WILL HAVE A VERY FAST BOOTING AND RUNNING PROGRAM. ╦EEP IN MIND THAT IT WAS PRETTY SIMPLE TO CREATE YOUR ┴╙╘╥╧ ═┼╬╒. ╔F YOU HAVE MADE A MISTAKE, OR EVEN TWO, IT'S PRETTY SIMPLE TO CHANGE THOSE MISTAKES. ╔F YOU ARE A PROGRAMER, YOU COULD GO TO THE ─┴╘┴ STATEMENTS NEAR THE END OF THE PROGRAM AND CORRECT THE MISTAKES HERE, KEEPING IN MIND THAT THERE MUST BE A ALL THE DATA STATEMENTS DESIGNED INTO THE PROGRAM OR AN ERROR WILL OCCUR. ┴LSO, THE QUOTES IN THE TITLE OF THE PROGRAM MUST BE THERE FOR IT TO PRINT CORRECTLY. ╘HE NAME OF THE SUB TITLE IN LINE 6000 MUST HAVE A THE CORRECT NUMBER OF CHARACTERS OR YOUR SCREEN WILL LOOK FUNNY. ╔F YOU ARE NOT A PROGRAMER AND WANT TO CHANGE YOUR ┴╙╘╥╧ ═┼╬╒, JUST DECIDE WHAT CHANGES YOU WANT MADE, AND RUN THE ┴╙╘╥╧ ╫╥╔╘┼╥ AGAIN. ╘HEN YOU MUST REMOVE THE OLD COPY FROM THE DISK AND INSTALL THE NEW ONE. ╘HERE IS A VERY EASY COMMAND TO REMOVE A FILE FROM YOUR DISK AND IT WORKS AS FOLLOWS. 1. TYPE IN DIRECT MODE - SCRATCH "ASTRO MENU" █RETURN KEY▌ REMEMBER ANYTHING IN BRACKETS MEANS TO DO THAT FUNCTION, THE █RETURN KEY▌ MEANS PRESS RETURN. 2. THE COMPUTER WILL ASK "ARE YOU SURE" AND YOU TYPE - YES █RETURN KEY▌ 3. IT WILL DO THAT FUNCTION AND GIVE YOU A READY PROMPT. ┴╙╘╥╧ ═┼╬╒ ╨┴╟┼ 5 ┘OU ARE NOW READY TO SAVE YOUR NEW COPY OF ┴╙╘╥╧ ═┼╬╒ TO YOUR DISK BY TYPING: DSAVE "ASTRO MENU" █RETURN KEY▌ ╘HERE YOU GO, YOUR NOW READY TO RUN YOUR NEW COPY OF ┴╙╘╥╧ ═┼╬╒. -------------------------------------------- ╠ET'S LOOK AT A FEW OF THOSE OTHER GOODIES FOR A MINUTE. ╞3 -- ┬ASIC 7 ╫HEN YOU CHOSE THIS FUNCTION, THE PROGRAM WILL DO 3 DIFFERENT THINGS. ╞IRST OFF WI ENDS THE PROGRAM IN A PROPER MANNER CLOSING FILES AND CLEARING THE MEMORY. ╙ECONDLY IT CHANGES THE FUNCTION KEYS BACK TO THEIR COLD START FUNCTIONS, EXCEPT FOR THE ╞1 KEY. ╘HIS KEY WILL NOW BRING UP A DIRECTORY ON DRIVE 9. ╠AST BUT NOT LEAST, IT PRINTS TO THE SCREEN CREDITS THAT ARE STORED INSIDE YOUR ├=128. ╘HESE ARE IMPRINTED IN ONE OF THE ╥╧═ CHIPS INSIDE YOUR COMPUTER. ╞4 -- ─╔╙╦ ╔ HAVE PUT THIS HERE TO MAKE IT EASIER FOR YOU TO GO TO YOUR FAVORITE ─╧╙ UTILITY DISK. ╩UST NAME YOUR UTILITY "DISK" AND THE PROGRAM WILL LOAD AND RUN THEM FROM THIS FUNCTION. ┴N INTERESTING THING HERE, IF YOU HAVE AN EXIT FROM YOUR ─╧╙ DISK, MAKE IT DO A BOOT COMMAND AND IT WILL AUTOMATICALLY RUN ┴╙╘╥╧ ═┼╬╒ FROM THAT. ╬ICE ╚╒╚! ╞6 -- ─╔╥/╨╥╘ ╘O MAKE IT EASIER FOR ALL TO WORK WITH THEIR DISKS, ╔ HAVE ADDED A DIRECTORY PRINT TO PRINTER COMMAND. ╘HIS WILL PRINT THE DIRECTORY OF DRIVE 8 TO YOUR UNIT 4 PRINTER. ╔T ISN'T A REAL FAST PROGRAM, BUT IT DOES THE JOB. ╞7 -- ╚┼╠╨ ╞╔ ╘HIS COMMAND WILL BRING UP A HELP FILE THAT YOU CREATE. ╔T MAY BE SELF RUNNING DOCUMENTATION, OR THIS DOCUMENTATION RUN ON A FILE DISPLAYER/PRINTER. ╘HE CHOICE IS YOURS, AGAIN. ╞8 -- ├╚╟/─╥╔╓┼ ╘HIS GREAT LITTLE UTILITY WILL CHANGE YOUR DRIVES TO WHAT EVER YOU CHOSE JUST AS LONG AS YOU WANT UNITS 8 OR 9 OR 10. ┘OU CAN SWAP UNITS, SUCH AS CHANGING 8 TO 9 AND 9 TO 8 SO YOU CAN GET A HARD COPY OF THE DIRECTORY ON DRIVE 9. ╧R JUST SIMPLY CHANGE A UNIT TO ANOTHER UNIT, 8 TO 10 FOR EXAMPLE. ╧R THE LETTER "┌" WILL ABORT THE PROCESS. ╘HESE ARE SOFTWARE CHANGES AND YOUR DRIVES WILL RETURN TO THEIR ORIGINAL UNIT NUMBERS WHEN THEY ARE TURNED OFF. ---------------------------- ╥EMEMBER! ╘HIS IS SHAREWARE AND THE AUTHOR SPENT ╠╧╘╙ OF TIME GETTING THIS JUST RIGHT, SO HELP HIM OUT AND MAKE A SIMPLE $5 DONATION. ╘HANKS. ╙EE ┘OU ╔N ╘HE ╞╒╬╬┘ ╨┴╨┼╥╙! ║║ * :